home *** CD-ROM | disk | FTP | other *** search
/ BMUG Revelations / BMUG Revelations.toast / Utilities / Screen Savers / MeanScreen 1.0 / Read Me < prev   
Text File  |  1992-04-25  |  5KB  |  61 lines
  1. DOCUMENTATION FOR MeanScreen v. 1.0 by John Butler
  2.  
  3. WHAT IT DOES
  4. A screen saver INIT.
  5.  
  6. WHAT DOES IT ALL MEAN?
  7. Don't waste your time searching for some significance in the name MeanScreen.  It was a no-brain choice for a difficult-to-name piece of software.
  8.  
  9. CREDIT
  10. I can take almost no credit for this INIT.  Proper credit for the "Flying Line" algorithm goes to Dave Mark and Cartwright Reed, authors of Macintosh C Programming Primer.  The rest of the credit goes to Christopher Tate at Penn State, and a large portion of MeanScreen is under his copyright.  I take credit only for getting it to work under Think C 5.0 and for patching it all together.
  11.  
  12. SHOW ME THE WAY
  13. Simply restart your Mac with MeanScreen in the System folder.  The screen saver activates after 2 minutes of idle, and deactivates with any mouse movement or keypress.
  14.  
  15. TESTIMONIAL
  16. I use MeanScreen religiously.  A screen saver is vital to any Mac user and this one is extremely well-mannered.  It lacks the frills of After Dark or other commercial offerings, but what it lacks it makes up for in reliability.  MeanScreen has NEVER caused a crash on my Mac and has never conflicted with any other init or application.  By contrast, After Dark crashed while using ResEdit only minutes after I began using it and trashed a precious file -- I never used it again.
  17.  
  18. FREEWARE
  19. MeanScreen is free and may be distributed freely, provided Christopher Tate's limitations are observed. (See SHELL DOCS below)
  20.  
  21. Any comments for this author are appreciated and I can be reached at:
  22.  
  23. America Online     ...    JohnB42414    (preferably) -or -
  24. CompuServe                ...    76366,723                                                    -or-
  25.  
  26. US Postal Service:    John Butler
  27.                                                             2061 Vinton Avenue
  28.                                                             Memphis, Tennessee  38104
  29.  
  30. ALSO FROM JOHN BUTLER
  31.  
  32. Macman 1.0.2     ... a clone of PAC-MAN
  33.                                                  I have been told there was a game called MacMan in the past.
  34.                                                  This is not the same game, no infringement intended.
  35.                                                  Try it, hands down my largest and best effort to date. 
  36.                                                  (Shareware)
  37.  
  38. EInfo 1.0                    ... a quick and dirty utility to edit type and creator codes on
  39.                                                  HFS or MFS files
  40.  
  41. BaseCalc 1.0         ... a quick and dirty mini-application to convert 32-bit
  42.                                                  numbers between binary, decimal, and hex
  43.                                                  (Apple says in the age of System 7.0, don't write any more
  44.                                                  desk accessories, so it's a mini-app.)
  45.  
  46. SHELL DOCS
  47. The rest of this file contains parts of the documentation provided with the screen saver shell by Christopher Tate (known as Public Blanket).
  48.  
  49. This program was developed by Christopher Tate at the Pennsylvania State
  50. University, and is copyright ©1991 by the author.  All rights are given for anyone to freely modify this code and use it in your own programs so long as credit is given to Christopher Tate in your "About Box" or documentation.  The author disclaims all damages which may occur as a result of this code; in short, use it at your own risk.
  51.  
  52. The code has been tested on several machines under several different versions of the system, including System 7.0b4, and seems to be quite well-behaved.  However, it's not perfect.  I have found at least one application which seems somehow to prevent Blanket from activating, for no known reason.  My only comfort is that After Dark 2.0 exhibits the same problem with that application.  :-)
  53.  
  54. The screen saver works by patching _SystemTask, the routine that doles out time to desk accessories and performs other periodic system tasks.  In Inside Macintosh, Apple recommends that applications call SystemTask() as often as possible; at least every sixtieth of a second.  Note that WaitNextEvent() calls SystemTask() itself.
  55.  
  56. Blanket intercepts calls to _SystemTask and uses the opportunity to keep track of the time elapsed since the user performed an action -- mouse movement or clicks, or keypresses.  If the specified amount of time (the #define'd constant BLANK_TIME) has elapsed since such an event occurred, the screen is erased to black.  When the user finally causes one of the above events to occur, Blanket removes its GrafPort and causes the Window Manager to update all windows.
  57.  
  58. When drawing to the screen, Blanket uses Alex Chaffee's method for synchronizing to the vertical retrace interrupt.  This method was distributed on the Usenet group  comp.sys.mac.programmer.
  59.  
  60. Thanks to Ari Halberstadt, Michael Pierce, Jim Cathey, and Larry Rosenstein for wonderful suggestions that I didn't wind up using.  :-)  Special thanks to jwinterm@jarthur.claremont.edu for debugging tips.
  61.